home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 036a / syscols.zip / SYSCOLS.DOC next >
Text File  |  1991-06-22  |  7KB  |  176 lines
  1.                               SYSCOLS.DOC
  2.                           ver 1.0   June, 1991
  3.  
  4.       Presentation Manager System Color Configuration Program
  5.  
  6. This program offers configuration of OS/2 Presentation Manager's system
  7. colors.  It offers several advantages over OS/2's Control Panel.  These
  8. include:
  9. * 32 system colors can be changed whereas the Control Panel only allows
  10.   configuration of 26 colors.  (the Color Template "Different", although
  11.   some may think it ugly, serves to demonstrate each system object as a
  12.   different color)
  13. * Most color changes are visible immediately.
  14. * Sample Color Templates are available.  Additional Templates can be
  15.   created, or existing ones can be modified.
  16. * Colors can be set temporarily or permanently.
  17. * A color template can be loaded from the command line (ideal for use in
  18.   .CMD files).
  19.  
  20.  
  21. FILES
  22.  
  23. Required files: SYSCOLS.EXE, SYSCOLS.HLP, SYSCOLS.INI
  24. Ideally, these three files should be placed in the same directory.   For
  25. online help and color template choices the .HLP and .INI files need to be
  26. in the default directory.
  27.  
  28.  
  29. ON-LINE HELP
  30.  
  31. SYSCOLS provides hypertext, context-sensitive help from either the help
  32. menu or by pressing F1.  Further details concerning the running of this program
  33. can be found in the online help.  For online help to be available, the
  34. SYSCOLS.HLP file is needed.  To load color templates, the SYSCOLS.INI file is
  35. needed.  SYSCOLS looks in current directory for the .HLP help and .INI
  36. initialiation files.  If either file is not found when the program is invoked, a
  37. message box is displayed.  If you add a program entry icon for SYSCOLS, set the
  38. working directory to the directory where SYSCOLS.EXE, SYSCOLS.HLP, and
  39. SYSCOLS.INI, are located.
  40.  
  41.  
  42. PURE VERSES DITHERED COLORS
  43.  
  44. Appparently, Presentation Manager does it's best to find matching display
  45. colors for the colors you choose, however for colors applied to certain
  46. system objects, the results may be different from that displayed in the
  47. sample color area.  This is most likely due to Presentation Manager's
  48. rejection of dithered colors for some settings.   For example, this
  49. discrepancy is evident when you set the ButtonMiddle system object to a
  50. non-pure color.  It seems that non-pure colors can be applied to scroll box
  51. slider buttons, but not to push buttons.
  52.  
  53.  
  54. LOADING TEMPLATES FROM COMMAND lINE
  55.  
  56. A color template name can be specified on the command line using the syntax:
  57.  
  58.                   SYSCOLS ["]validtemplatename["] [/L]
  59.  
  60. where validtemplatename is space-sensitive but not case-sensitive, and /L
  61. indicates to load the main System Colors Configuration Presentation Manager
  62. screen after changing the colors.
  63.  
  64. Specifying color templates on the command line without loading the main screen
  65. is useful for .CMD files, especially if you run a program that conflicts
  66. with your default color choices.   Simply put the lines
  67.    SYSCOLS "newtemplatename"
  68.    <commands to run confliciting program>
  69.    SYSCOLS "default or oldtemplatename"
  70. in a .CMD file to set colors compatible with the program, run the program, and
  71. then set the colors back to your favorite selection.
  72. No action is taken if the color template name given on the command line is not
  73. found in this program's .INI file.   Note that the color template name is not
  74. case sensitive, but if the color template name consists of two or more words,
  75. the template name must be enclosed in quotes, as in "templatename" .
  76. For example,
  77.   SYSCOLS "Penn State"   is valid       SYSCOLS penn state   is not valid
  78.   SYSCOLS "penn state"   is valid       SYSCOLS pennstate    is not valid
  79.   SYSCOLS "pEnN sTaTe"   is valid       SYSCOLS PennState    is not valid
  80.  
  81.  
  82. If a paramater is given on the command line, the program simply searches for
  83. the color template name in the .INI file, and if it is found, the system
  84. colors are changed.  If the template name is not found, the colors do not
  85. change.  In either case, the Presentation Manager interactive screen is not
  86. invoked unless /l or /L is given as the second parameter.
  87.  
  88. SYSCOLS "penn state"  /l         Would change the colors and load the program.
  89. SYSCOLS "invalid template"  /l   Would not change the colors, however the
  90.                                  main System Colors Configuration Presentation
  91.                                  Manager screen would be loaded.
  92.  
  93.  
  94. For example, to change colors each day at system startup based on the day
  95. of the week, put the line   START C:\CMD\SETCOLRS   in STARTUP.CMD where
  96. SETCOLRS is a REXX command file is similar to:
  97.  
  98. /*  SETCOLRS.CMD    Sample REXX command file to demonstrate loading color
  99.     templates based on the day of the week.
  100.     Note that
  101.     - D:, SOURCE, D:\SOURCE\SYSCOLS should be replaced as per your
  102.       system requirements
  103.     - To load a template name containing more than one word, use '" name "'
  104. */
  105. "D:"
  106. "chdir \SOURCE"
  107. commandline = "D:\SOURCE\SYSCOLS "
  108. if Date('W') = 'Monday' then
  109.      commandline = commandline || '"Default with a Twist"'
  110. if Date('W') = 'Tuesday' then
  111.      commandline = commandline || "bordeaux"
  112. if Date('W') = 'Wednesday' then
  113.      commandline = commandline || '"Penn State"'
  114. if Date('W') = 'Thursday' then
  115.      commandline = commandline || "southwest"
  116. if Date('W') = 'Friday' then
  117.      commandline = commandline || "southwest"
  118. commandline
  119. "exit"
  120.  
  121.  
  122.  
  123. SHARING COLOR TEMPLATES
  124.  
  125. If a friend has colors that you would like to add to your Color Templates,
  126. simply have him/her save their colors to a data file by selecting the Write
  127. action, then use Read to load the colors on your system, and optionally
  128. save them to a Color Template.  The color codes written to the data file
  129. are those of the colors currently in effect.
  130.  
  131.  
  132. ACTIONS
  133.  
  134. The following is a brief description of the available actions for this program.
  135. Further details can be found in the on-line help (F1).
  136.   Reset   to colors which were active when the program was invoked
  137.   Read    data file containing color codes to set
  138.   Keep    current screen colors for future sessions (Save to OS/2's .INI file)
  139.   Write   current color codes to data file
  140.   Set     colors to those defined in the color template selected in the
  141.           Color Templates list box
  142.   Delete  color template
  143.   Set     system colors object (i.e. Icon Text, Window Text, Background) to
  144.           the color displayed in the sample color region
  145.   Save    the currently selected system colors object and the color
  146.           selected in the sample area to an existing or new Color Template
  147.  
  148.  
  149.  
  150. REVISION HISTORY & REGISTRATION
  151.  
  152.    ver 1.0   June, 1991
  153.  
  154.    SYSCOLS development and testing began under OS/2 1.2 and continued under
  155.    version 1.3.  I would be most greatful for any comments, suggestions,
  156.    and/or bug reports.  SYSCOLS is distributed as-is, with no warranties
  157.    involved.
  158.  
  159.    You may give individual copies of the unregistered version SYSCOLS to
  160.    friends, associates, collegues, etc. for evaluation purposes, however,
  161.    please include the files SYSCOLS.EXE, SYSCOLS.HLP, SYSCOLS.INI, and
  162.    SYSCOLS.DOC without any modification.
  163.  
  164.    If you use SYSCOLS, please send a small donation of $15.00 so that I
  165.    can prove to my husband that all the long hours I spend with my PC
  166.    instead of with him are really worth something.  Thank you.
  167.    
  168.  
  169.    Donna Campanella
  170.    508 Natalie Lane
  171.    Norristown, PA 19401
  172.  
  173.    CompuServe 72010,2305
  174.    Prodigy    KCTW07A
  175.  
  176.